Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Configuring Sequence Grabber Components

SGNewChannelFromComponent

The SGNewChannelFromComponent function creates a sequence grabber channel and assigns a channel component to the channel. The channel component is responsible for providing digitized data to the sequence grabber component. You specify the channel component to be used.

pascal ComponentResult SGNewChannelFromComponent 
                      (SeqGrabComponent s, SGChannel *newChannel, 
                      Component sgChannelComponent);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

newChannel

Contains a pointer to a channel component that is to receive a reference to the channel that is added to the sequence grabber component. If the sequence grabber component successfully locates and connects to the specified channel component, the sequence grabber component returns a reference to the channel component into the field referred to by this parameter. If the sequence grabber component cannot open a connection, it sets the result code to a nonzero value.

sgChannelComponent

Identifies the channel component to use. You supply a component ID value to the sequence grabber. The sequence grabber then opens a connection to that channel component and returns your connection ID in the field specified by the newChannel parameter. You may obtain a component ID value by calling the Component Manager's FindNextComponent function.

DESCRIPTION

The sequence grabber component locates and connects to the specified channel component. If the sequence grabber component cannot locate or connect to the channel component, it returns a nonzero result code.

This function is similar to the SGNewChannel function, except that this function allows you to specify a particular component rather than just a component subtype value. Use this function if you want to connect to a specific component.

RESULT CODES

couldntGetRequiredComponent

-9405

Component not found

Memory Manager errors

SEE ALSO

You may also use the SGNewChannel function to establish a new channel. That function requires only a component subtype value, and is described on page 5-29.

When you are done with the sequence grabber component, you can dispose of the channels you have used by calling the SGDisposeChannel function, which is described on page 5-32.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help